Handling Movie Events5

QuickTime 2.1 provided two changes from movie event handling as documented in Chapter 2 of Inside Macintosh: QuickTime Components. First, a new flag can now be returned by the MCGetControllerInfo function. This flag indicates when a movie is interactive, and therefore it does not make sense to play it from end to end. Second, while it has always been possible to determine if a point is contained in a movie (using PtInMovie ), the new MCPtInController function provides a way to determine if a point is in the control area of a movie.

MCGetControllerInfo

The MCGetControllerInfo function returns a new flag to indicate that the movie is interactive and, therefore, cannot be played from start to end. For example, because users interact with a QuickTime VR movie, it cannot be played the same way that video movies can be played.

The someflags parameter to the MCGetControllerInfo function may return the following additional flag:



 
enum {

    mcInfoMovieIsInteractive    = 1 << 10,

};

Flag description

mcInfoMovieIsInteractive: If this flag is set to 1, the movie is interactive.

MCPtInController

The MCPtInController function reports whether a point is in the control area of a movie.



 
pascal ComponentResult MCPtInController (

                     MovieController mc,

                     Point thePt,

                     Boolean *inController);

mc: Specifies the movie controller for the operation. You obtain this identifier from the Component Manager's OpenComponent or OpenDefaultComponent function, or from the NewMovieController function.
thePt: Specifies the point to be checked. This point must be passed in local coordinates to the controller's window. This point is checked only against the movie controller's controls, not the movie itself.
inController: Returns true if the point is in the controller; false if it is not.

DISCUSSION

While you could always determine if a point is contained in a movie (using PtInMovie ), the MCPtInController function allows you to determine if a point is in the control area of a movie.